jp.co.ricoh.dsdk.scard.option.applet
Interface AppletService

All Known Implementing Classes:

AppletServiceImpl

public interface AppletService

This is a CardService interface which provides the access to a card applet.

Method Summary

ResponseAPDU	selectApplet(AppletID aid) Select an applet.
APDU	sendRequestAPDU(APDU apdu) Sends an APDU to the currently selected card applet.
APDU	sendRequestAPDU(AppletID aid, APDU apdu) Sends an APDU to the card applet which has the given AppletID.
byte[]	sendRequestAPDU(AppletID aid, byte[] request) Sends a command bytes to the card applet which has the given AppletID.
ResponseAPDU	sendRequestAPDU(AppletID aid, RequestAPDU requestAPDU) Sends a RequestAPDU to the card applet which has the given AppletID.
byte[]	sendRequestAPDU(byte[] request) Sends a command bytes to the currently selected card applet.
ResponseAPDU	sendRequestAPDU(RequestAPDU requestAPDU) Sends a RequestAPDU to the currently selected card applet.

Method Detail

selectApplet

public ResponseAPDU selectApplet(AppletID aid)
                          throws CardServiceException

Select an applet.

Parameters:

aid - the AppletID.

Returns:

the resulting ResponseAPDU received from the card.

Throws:

CardServiceException - if the applet selection failed.

sendRequestAPDU

public ResponseAPDU sendRequestAPDU(AppletID aid,
                                    RequestAPDU requestAPDU)
                             throws CardServiceException,
                                    APDUException

Sends a RequestAPDU to the card applet which has the given AppletID. The RequestAPDU will be sent after the applet selection.

Parameters:

aid - the AppletID.

requestAPDU - a RequestAPDU to be sent.

Returns:

the resulting ResponseAPDU received from the card.

Throws:

CardServiceException - if the service encountered an error.

APDUException - if the response length was shorter than the status words length.

sendRequestAPDU

public APDU sendRequestAPDU(AppletID aid,
                            APDU apdu)
                     throws CardServiceException

Sends an APDU to the card applet which has the given AppletID. The APDU will be sent after the applet selection.

Parameters:

aid - the AppletID.

apdu - an APDU to be sent.

Returns:

the resulting APDU received from the card.

Throws:

CardServiceException - if the service encountered an error.

sendRequestAPDU

public byte[] sendRequestAPDU(AppletID aid,
                              byte[] request)
                       throws CardServiceException

Sends a command bytes to the card applet which has the given AppletID. The command bytes will be sent after the applet selection.

Parameters:

aid - the AppletID.

request - a command bytes to be sent.

Returns:

the resulting command bytes received from the card.

Throws:

CardServiceException - if the service encountered an error.

sendRequestAPDU

public ResponseAPDU sendRequestAPDU(RequestAPDU requestAPDU)
                             throws CardServiceException,
                                    APDUException

Sends a RequestAPDU to the currently selected card applet.

Parameters:

requestAPDU - a RequestAPDU to be sent.

Returns:

the resulting ResponseAPDU received from the card.

Throws:

CardServiceException - if the service encountered an error.

APDUException - if the response length was shorter than the status words length.

sendRequestAPDU

public APDU sendRequestAPDU(APDU apdu)
                     throws CardServiceException

Sends an APDU to the currently selected card applet.

Parameters:

apdu - an APDU to be sent.

Returns:

the resulting APDU received from the card.

Throws:

CardServiceException - if the service encountered an error.

sendRequestAPDU

public byte[] sendRequestAPDU(byte[] request)
                       throws CardServiceException

Sends a command bytes to the currently selected card applet.

Parameters:

request - a command bytes to be sent.

Returns:

the resulting command bytes received from the card.

Throws:

CardServiceException - if the service encountered an error.